home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1999 May: Tool Chest / Developer CD Series Tool Chest (Apple Computer)(May 1999).iso / Tool Chest / Development Kits / MPW etc / MPW-PR / Interfaces&Libraries / Multiprocessing StdCLib / CIncludes / stdio.h < prev    next >
Encoding:
C/C++ Source or Header  |  1997-03-06  |  7.4 KB  |  300 lines  |  [TEXT/MPS ]
  1. /*
  2.      File:        stdio.h
  3.  
  4.      Contains:    Standard input and output.
  5.  
  6.      Version:    Technology:    StdCLib 3.4
  7.                  Release:    3.6d2
  8.  
  9.      Copyright:    © 1987-1996 by Apple Computer, Inc., all rights reserved.
  10.  
  11.      Bugs?:        If you find a problem with this file, send the file and version
  12.                  information (from above) and the problem description to:
  13.  
  14.                      Internet:    apple.bugs@applelink.apple.com
  15.                      AppleLink:    APPLE.BUGS
  16.  
  17. */
  18.  
  19.  
  20. /*
  21.  * Include common declarations 
  22.  */
  23. #ifndef __STDIO__
  24. #define __STDIO__
  25.  
  26. #ifndef __CONDITIONALMACROS__
  27. #include <ConditionalMacros.h>
  28. #endif
  29. #ifndef __NULLDEF__
  30. #include <NullDef.h>
  31. #endif
  32. #ifndef __SIZETDEF__
  33. #include <SizeTDef.h>
  34. #endif
  35. #ifndef __SEEKDEFS__
  36. #include <SeekDefs.h>
  37. #endif
  38. #ifndef __VALISTTDEF__
  39. #include <VaListTDef.h>
  40. #endif
  41.  
  42.  
  43.  
  44.  
  45. #if PRAGMA_ONCE_SUPPORTED
  46. #pragma once
  47. #endif  /* PRAGMA_ONCE_SUPPORTED */
  48.  
  49. #ifdef __cplusplus
  50. extern "C" {
  51. #endif
  52.  
  53. #if PRAGMA_IMPORT_SUPPORTED
  54. #pragma import on
  55. #endif
  56.  
  57. #if PRAGMA_ALIGN_SUPPORTED
  58. #pragma options align=mac68k
  59. #elif PRAGMA_PACK_SUPPORTED
  60. #pragma pack(push, 2)
  61. #endif
  62.  
  63.  
  64.  
  65.  
  66. /*
  67.  *  The basic data structure for a stream is the FILE type.
  68.  */
  69.  
  70. #ifdef powerc
  71. #pragma options align=power
  72. #endif
  73. struct FILE {
  74.     int                             _cnt;
  75.     unsigned char *                    _ptr;
  76.     unsigned char *                    _base;
  77.     unsigned char *                    _end;
  78.     unsigned short                     _size;
  79.     unsigned short                     _flag;
  80.     unsigned short                     _file;
  81. };
  82. typedef struct FILE FILE;
  83.  
  84. #ifdef powerc
  85. #pragma options align=reset
  86. #endif
  87.  
  88. /*
  89.  *  The type to uniquely specify the position in a file, returned by fgetpos().
  90.  */
  91.  
  92. typedef long                             fpos_t;
  93.  
  94. /*
  95.  *  Values for various bits of a FILE's _flag field.
  96.  *  The values _IOFBF, _IOLBF, and _IONBF can be used as the
  97.  *  third argument to setvbuf();
  98.  */
  99.  
  100. #define _IOFBF      0x00    /* File is fully buffered       */
  101. #define _IOREAD     0x01    /* File is open for Reading     */
  102. #define _IOWRT      0x02    /* File is open for Writing     */
  103. #define _IONBF      0x04    /* File I/O is unbuffered       */
  104. #define _IOMYBUF    0x08    /* Buffer allocated by stdio    */
  105. #define _IOEOF      0x10    /* End of file reached          */
  106. #define _IOERR      0x20    /* I/O error has occurred       */
  107. #define _IOLBF      0x40    /* File is line buffered        */
  108. #define _IORW       0x80    /* File is open for Read/Write  */
  109. #define _IOSYNC    0x100    /* Flush output on Read         */
  110. #define _IOBINARY  0x200    /* For backward compatibility   */
  111. #define _IOBACK   0x4000    /* For backward compatibility   */
  112.  
  113. /*
  114.  *  The default buffer sizes for a fully buffered or line buffered file.
  115.  */
  116.  
  117. #define BUFSIZ    1024
  118. #define _LBFSIZ    254
  119.  
  120. /*
  121.  *  The normal end-of-file indicator.
  122.  */
  123.  
  124. #define EOF       (-1)
  125.  
  126. /*
  127.  *  FOPEN_MAX is the minimum number of files that a program is guaranteed to be able
  128.  *  to have open simultaneously (including the pre-opened stdin, stdout, and stderr).
  129.  *  The numbers are listed in Inside Macintosh, page IV-178, as:
  130.  *  64K ROM, 128K Macintosh     12 files
  131.  *  64K ROM, 512K Macintosh     40 files
  132.  *  128K ROM                    40 files per volume
  133.  *
  134.  *  FILENAME_MAX is the maximum length of a file name, including a trailing zero byte.
  135.  */
  136.  
  137. #define FOPEN_MAX      12
  138. #define FILENAME_MAX   32
  139.  
  140. /*
  141.  *  L_tmpnam is the size of char array long enough to hold a temporary file name
  142.  *  generated by tmpnam(), including the trailing null byte.  The name is in the
  143.  *  form tmp.AAAXXXXXX, where AAA is a sequence of lower case letters ("aaa", "baa",
  144.  *  ... "zzz" on successive calls), and XXXXXX is a lower case letter followed by a sequence
  145.  *  of digits, all determined at runtime.
  146.  */
  147.  
  148. #define L_tmpnam       14
  149.  
  150. /*
  151.  *  TMP_MAX is the number of distinct file names that tmpnam() can generate.
  152.  */
  153.  
  154. #define TMP_MAX     17576
  155.  
  156. /*
  157.  *  The standard predefined streams: error, input, and output
  158.  */
  159.  
  160. #define stdin        ( &_iob[ 0 ] )
  161. #define stdout       ( &_iob[ 1 ] )
  162. #define stderr       ( &_iob[ 2 ] )
  163.  
  164. /*
  165.  * Operations on Files
  166.  */
  167.  
  168. extern int remove(const char *filename);
  169. extern int rename(const char *oldname, const char *newname);
  170. extern FILE *tmpfile(void );
  171. extern char *tmpnam(char *s);
  172.  
  173. /*
  174.  * File Access Functions
  175.  */
  176.  
  177. extern int fclose(FILE *stream);
  178. extern int fflush(FILE *stream);
  179. extern FILE *fopen(const char *filename, const char *mode);
  180. extern FILE *freopen(const char *filename, const char *mode, FILE *stream);
  181. extern void setbuf(FILE *stream, char *buf);
  182. extern int setvbuf(FILE *stream, char *buf, int mode, size_t size);
  183.  
  184. /*
  185.  * Formatted Input/Output Functions
  186.  */
  187.  
  188. extern int fprintf(FILE *stream, const char *format, ...);
  189. extern int fscanf(FILE *stream, const char *format, ...);
  190. extern int printf(const char *format, ...);
  191. extern int scanf(const char *format, ...);
  192. extern int sprintf(char *s, const char *format, ...);
  193. extern int sscanf(const char *s, const char *format, ...);
  194. extern int vfprintf(FILE *stream, const char *format, va_list arg);
  195. extern int vprintf(const char *format, va_list arg);
  196. extern int vsprintf(char *s, const char *format, va_list arg);
  197.  
  198. /*
  199.  * Character Input/Output Functions
  200.  */
  201.  
  202. extern int fgetc(FILE *stream);
  203. extern char *fgets(char *s, int n, FILE *stream);
  204. extern int fputc(int c, FILE *stream);
  205. extern int fputs(const char *s, FILE *stream);
  206. extern int getc(FILE *stream);
  207. extern int getchar(void );
  208. extern char *gets(char *s);
  209. extern int putc(int c, FILE *stream);
  210. extern int putchar(int c);
  211. extern int puts(const char *s);
  212. extern int ungetc(int c, FILE *stream);
  213.  
  214. /*
  215.  * WARNING!!
  216.  *
  217.  * These macros evaluate their arguments more than once.
  218.  * Be sure that evaluation of the "s" argument has no side effects.
  219.  *
  220.  * For example, using "getc(mychar++)" would cause "mychar" to be
  221.  * incremented twice.
  222.  *
  223.  * To avoid this, either assign "mychar" to a temporary, or put the
  224.  * function name in paranthesis, so that the macro is not envoked:
  225.  *    "(getc)(mychar++)"
  226.  *
  227.  */
  228.  
  229. #define getchar() (getc(stdin))
  230. #define putchar(c) (putc((c), stdout))
  231.  
  232. /*
  233.  * Direct Input/Output Functions
  234.  */
  235.  
  236. extern size_t fread(void *ptr, size_t size, size_t nmemb, FILE *stream);
  237. extern size_t fwrite(const void *ptr, size_t size, size_t nmemb, FILE *stream);
  238.  
  239. /*
  240.  * File Positioning Functions
  241.  */
  242.  
  243. extern int fgetpos(FILE *stream, fpos_t *pos);
  244. extern int fseek(FILE *stream, long offset, int whence);
  245. extern int fsetpos(FILE *stream, const fpos_t *pos);
  246. extern long ftell(FILE *stream);
  247. extern void rewind(FILE *stream);
  248.  
  249. /*
  250.  * Error Handling Functions
  251.  */
  252.  
  253. extern void clearerr(FILE *stream);
  254. extern int feof(FILE *stream);
  255. extern int ferror(FILE *stream);
  256. extern void perror(const char *s);
  257.  
  258. /*
  259.  * Internal structures exposed by previous macro definitions.
  260.  */
  261.  
  262. extern FILE _iob[ ];    /* Array of FILE control blocks. */
  263. #define _NFILE 40      /* Size of _iob. */
  264.  
  265. /*
  266.  *  Non-ANSI extensions
  267.  *
  268.  * The prefered mechanism for enabling these is by defining __useAppleExts__.  
  269.  * In the absence of this symbol, the __STDC__ symbol is used to enable or
  270.  * disable these extentions.
  271.  */
  272.  
  273. #if defined(__useAppleExts__) || defined(applec) && !defined(__STDC__) || defined(__PPCC__) && !__STDC__
  274.  
  275. extern FILE *fdopen(int fildes, const char *mode);
  276. extern void fsetfileinfo(const char *filename, unsigned long newcreator, unsigned long newtype);
  277. extern int getw(FILE *stream);
  278. extern int putw(int w, FILE *stream);
  279.  
  280. #endif  /*  defined(__useAppleExts__)  || ( defined(applec)  &&  ! defined(__STDC__) ) || ( defined(__PPCC__)  &&  !__STDC__) */
  281.  
  282.  
  283.  
  284. #if PRAGMA_ALIGN_SUPPORTED
  285. #pragma options align=reset
  286. #elif PRAGMA_PACK_SUPPORTED
  287. #pragma pack(pop)
  288. #endif
  289.  
  290. #if PRAGMA_IMPORT_SUPPORTED
  291. #pragma import off
  292. #endif
  293.  
  294. #ifdef __cplusplus
  295. }
  296. #endif
  297.  
  298. #endif /* __STDIO__ */
  299.  
  300.